home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / utils / clok132.zip / CLOCK.DOC next >
Text File  |  1996-04-21  |  10KB  |  323 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   C L O C K
  12.  
  13.                                     v 1.32
  14.  
  15.                       Copyright 1994 Vincent Penquerc'h
  16.                              All Rights Reserved
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                             DISCLAIMER OF WARRANTY
  26.  
  27.  
  28. THE AUTHOR WILL REFER TO VINCENT PENQUERC'H.
  29.  
  30. THE PROGRAM WILL REFER TO CLOCK, INCLUDING THE PROGRAM ITSELF, ITS
  31. DOCUMENTATION, AND ANY FILE IN THE ORIGINAL CLOCK PACKAGE.
  32.  
  33. THE AUTHOR HEREBY DISCLAIMS ALL WARRANTIES RELATING TO THIS PROGRAM,
  34. WHENEVER EXPRESSED OR IMPLIED, INCLUDING WITHOUT ANY LIMITATION ANY
  35. IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  36.  
  37. THE AUTHOR WILL NOT BE LIABLE FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL,
  38. INDIRECT OR SIMILAR DAMAGES DUE TO LOSS OF DATA, DAMAGE OF HARDWARE OR
  39. ANY OTHER REASON, EVEN IF THE AUTHOR WAS ADVISED OF THE POSSIBILITY OF
  40. SUCH LOSS OR DAMAGE.
  41.  
  42. THIS PROGRAM AND DOCUMENTATION ARE RELEASED "AS IS" AS FREEWARE. HOWEVER,
  43. IT IS COPYRIGHTED BY THE AUTHOR, AND ALL RIGHTS AND OWNERSHIP ARE KEPT
  44. WITH THE AUTHOR. YOU MAY USE IT, COPY IT, AND GIVE IT TO ANYBODY AS LONG
  45. AS NO MODIFICATIONS ARE MADE.
  46.  
  47. PROGRAM AND DOCUMENTATION COPYRIGHT 1994 VINCENT 'INDY' PENQUERC'H, ALL
  48. RIGHTS RESERVED.
  49.  
  50. ALL QUOTED PRODUCT AND COMPANY NAMES ARE TRADEMARKS OF THEIR RESPECTIVE
  51. OWNERS.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                          TABLE OF CONTENTS
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.       1. What is Clock ?
  70.       2. System requirements
  71.       3. Using Clock
  72.       4. Command line options
  73.       5. Troubleshooting
  74.       6. Contacting the author
  75.       7. Revision history
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.    1. What is Clock ?
  85.       ---------------
  86.  
  87.  
  88.       Clock is a useful tool that allows you to get an eye on the time while
  89.       working. You just hit a key combination and the time is displayed on
  90.       the top of the screen. For you who don't have a watch or a clock on
  91.       the wall, Clock is for you. Clock supports all video text modes, even
  92.       specific hi resolution super VGA ones, and will display the system
  93.       clock in the upper right corner. Clock allows you to select an 'alarm'
  94.       time, and will warn you with a ring when this time will be reached.
  95.       And most of all, Clock only needs 496 bytes in memory.
  96.  
  97.  
  98.  
  99.  
  100.    2. System requirements
  101.       -------------------
  102.  
  103.  
  104.       Clock needs a 286 in order to work well, since earlier PCs don't have
  105.       any Real Time Clock. You also need 496 bytes free in memory.
  106.  
  107.  
  108.  
  109.  
  110.    3. Using Clock
  111.       -----------
  112.  
  113.  
  114.  
  115.       Once resident, Clock displays the system clock in the upper right
  116.       corner of the screen. If you selected a non permanent clock, you
  117.       may call the resident routine at any time pressing Ctrl-Right Shift
  118.       to have the clock displayed. To select an alarm time, follow the
  119.       instructions given in the Command line options section, for the 'A'
  120.       option, which sets the alarm time.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.    4. Command Line options
  127.       --------------------
  128.  
  129.       Clock can be called with several options on its command line, they
  130.       are here presented and explained. Clock doesn't care of the case of
  131.       the letters. These options can be browsed by typing one of the
  132.       following commands:
  133.  
  134.         CLOCK -H
  135.         CLOCK -?
  136.  
  137.  
  138.  
  139.  
  140.       These commands display a short help with all avalaible command line
  141.       options and a brief description of what they do. To remove Clock from
  142.       memory, type:
  143.  
  144.         CLOCK -U
  145.  
  146.       'U' stands for 'Unload'. If Clock can't unload itself, it will warn
  147.       you. You can select a permanent clock, that will be displayed and
  148.       updated on the screen continuously, even if the hotkey is not pressed.
  149.       You may choose this by typing the folowing command:
  150.  
  151.         CLOCK -P
  152.  
  153.       'P' stands for 'Permanent'. This option may hide some data displayed
  154.       by some programs, so it should be used cautiously. You can also ask
  155.       Clock to warn you with an alarm at a cetain time. To do this, just use
  156.       the following command:
  157.  
  158.         CLOCK -Ahh:mm:ss
  159.  
  160.       'A' stands for 'Alarm'. hh:mm:ss represents the time in hours minutes
  161.       and seconds. You have to specify two digits for each component. If you
  162.       want the alarm to be triggered at 4pm, just enter:
  163.  
  164.         CLOCK -A16:00:00
  165.  
  166.       When the system clock will reach the alarm time, the selected action
  167.       will happen. The default behavior is a bell ring. Nothing is displayed
  168.       to prevent Clock from disturbing other application's screens. You can
  169.       also choose to reboot the computer at alarm time, instead of ringing,
  170.       by typing the command:
  171.  
  172.         CLOCK -Ahh:mm:ss -B
  173.  
  174.       'B' stands for 'Boot'. You may choose a warm or a cold boot by adding
  175.       the letter 'W' for warm or 'C' for cold:
  176.  
  177.         CLOCK -Ahh:mm:ss -BC
  178.         CLOCK -Ahh:mm:ss -BW
  179.  
  180.       The default is to perform a warm boot, that skips memory tests and
  181.       CRT initialization. Note that if you choose the boot feature, Clock
  182.       will take 544 bytes in memory instead of 496, because it allocates
  183.       some more space for the code to warn disk caching programs so no data
  184.       loss occurs. If you only want to know what time it is without keeping
  185.       Clock in memory, you may just type:
  186.  
  187.         CLOCK -N
  188.  
  189.       'N' stands for 'Non resident'. Clock will display the time without
  190.       staying resident in memory. This option would be quite useful when
  191.       you make batch programs where you want to display the time, as the
  192.       DOS command waits for a new time to be entered, or at least 'Enter'
  193.       to be pressed. You can redirect the output to the NUL device:
  194.  
  195.         CLOCK -N > NUL
  196.  
  197.       The copyright message will not be displayed and the time will appear.
  198.  
  199.  
  200.       Note that you can't set an alarm time if you use the 'N' switch, as
  201.       Clock can't redirect interrupts to its own code, as it it flushed away
  202.       from memory when it finishes. Setting an alarm time will be taken into
  203.       account only without use of the 'N' switch. Finally, you may also want
  204.       to change the system time, in case the CMOS battery got weak. To do
  205.       this, use the command:
  206.  
  207.         CLOCK -Thh:mm:ss
  208.  
  209.       'T' stands for 'Time'. The CMOS will be loaded with the new specified
  210.       time. To select the messages language, use the 'L' option:
  211.  
  212.         CLOCK -L FRENCH
  213.  
  214.       The supported languages are English (default), French and Spanish.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.    5. Troubleshooting
  221.       ---------------
  222.  
  223.  
  224.       Q: I get the message 'Real Time Clock Power Supply is low ....'
  225.       A: Clock has detected that the battery is weak. You should replace it
  226.          soon in order to keep your PC working well. Keeping this battery
  227.          could cause loss of data in the CMOS memory.
  228.  
  229.       Q: I get the message 'Clock can't be uninstalled ....'
  230.       A: As this message says, another program has hooked an interrupt used
  231.          by Clock. Unloading Clock would then crash the system. Try to
  232.          remove the program that hooked the interrupt, unload Clock, then
  233.          load the program again.
  234.  
  235.       Q: I get the message 'Clock not installed'
  236.       A: You requested Clock to unload itself from memory, but Clock did
  237.          not detect any copy of it in memory. If there is one, it might be
  238.          because a program hooked the multiplexer interrupt and did weird
  239.          things with it, so Clock doesn't receive requests any more. Another
  240.          possibility is a multiplexer conflict, if another program is using
  241.          the same multiplexer identification. This is very unlikely but it
  242.          can happen. Try to remove some of your resident programs to know
  243.          which one causes the conflict.
  244.  
  245.       Q: I get the message 'Clock is already resident in memory'
  246.       A: You tried to load Clock more than once, and it sensed there was
  247.          another copy of it in memory, so there is no need to have two
  248.          copies of Clock in memory. If Clock is not installed, it might be
  249.          a multiplexer conflict, as some resident program might use the
  250.          same multiplexer identification. This is very unlikely, but it can
  251.          happen. Try to remove some of your resident programs to determine
  252.          which one causes the conflict.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.    6. Contacting the author
  260.       ---------------------
  261.  
  262.  
  263.       If you have any bug reports, comments, or flames, feel free to write
  264.       me at the following email address:
  265.  
  266.       penquerc@enssat.fr
  267.  
  268.       or via snail mail:
  269.  
  270.       Vincent Penquerc'h
  271.       3, rue d'Ecosse
  272.       35200 Rennes
  273.       France
  274.  
  275.  
  276.  
  277.  
  278.       There is no registration fee for this program since it is freeware.
  279.       However, if you find it useful, I would appreciate very much if you
  280.       would send me a little sum of money. If you do so, please send cash
  281.       in french francs or a check drawn in french francs, as banks here
  282.       take lots of money to cash a check in another currency.
  283.  
  284.  
  285.  
  286.  
  287.  
  288.    7. Revision history
  289.       ----------------
  290.  
  291.  
  292.    v1.32  April 14th 1996 
  293.             - Added keypress wait feature.
  294.  
  295.  
  296.    v1.31  April 23rd 1995
  297.             - Enhanced command line parsing.
  298.  
  299.  
  300.    v1.3   September 12th 1994
  301.             - Added language support, with english, french and spanish
  302.  
  303.  
  304.    v1.21  August 19th (not released)
  305.             - Installed permanent multiplex interrupt handler.
  306.  
  307.  
  308.    v1.2   August 6th 1994 (not released)
  309.             - Added code to signal disk caching programs before attempting
  310.               to boot, and let them flush buffers.
  311.             - Added warm or cold boot choice.
  312.  
  313.  
  314.    v1.1   July 21st 1994 (not released)
  315.             - Added possibility to change system time.
  316.             - Added boot possibility at alarm time.
  317.             - Fixed a bug that would accept hours in range 0 to 59.
  318.  
  319.  
  320.    v1.0   July 3rd 1994 (not released)
  321.             - First version of Clock.
  322.  
  323.